home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu064.dms / pu064.adf / DSD / DSD.doc / DSD.doc
Text File  |  1990-03-25  |  11KB  |  333 lines
  1.             Disk Storage Deluxe 1.00   By: Khalid Aldoseri.
  2.             -----------------------------------------------
  3.  
  4.             
  5.     
  6. INTRODUCTION:
  7. -------------
  8.         
  9.     This is a small program that will run from either the WB or CLI. It will
  10. open its own window and display a list of ALL currently mounted devices,
  11. including hard disk partitions.  
  12.  
  13.  
  14.     The window displays the following info:
  15.  
  16.  
  17. -   Name:
  18.     This is the AmigaDOS name for the device.  E.G. DF0: DH0: VD0: etc.
  19.  
  20. -   Usage:
  21.     Shows a percentage of how full the device is.
  22.  
  23. -   Free:
  24.     Shows the amount of free storage left in a device.  (in KiloBytes)
  25.  
  26. -   Size:
  27.     Shows the total amount of storage a device has.  (also in K)
  28.  
  29. -   Volume:
  30.     This is the device volume.  E.G.  Workbench: Boot: etc.
  31.  
  32. -   Alarm:
  33.     This is the alarm level for the relevant device. (in K)  This will
  34.     be explained later.
  35.  
  36. -   Chip:
  37.     The amount of free Chip memory in the system.
  38.  
  39. -   Fast:
  40.     The amount of free Fast memory.
  41.  
  42. -   Total:
  43.     The total amount of free memory.
  44.  
  45. -   Chunks:
  46.     The number of free memory chunks available.  This gives you an idea of
  47.     how fragmented the computer's free memory list is.
  48.     
  49. -   RAM Disk Size:
  50.     This is the size of the RAM: disk device in kilobytes.
  51.  
  52.  
  53.  
  54. STORAGE ALARM:
  55. --------------
  56.  
  57.     Disk Storage Deluxe's (DSD) main function is to keep track of how much
  58. free storage is remaining in every device.  If the free storage in any device
  59. is less than 5% of its total size, that device will be highlighed.  Also, if
  60. the storage drops below 5% while DSD is running, DSD will inform you of the
  61. fact by a 'Storage Alarm.'  This can be any of the following types:
  62.  
  63. 1.  Flash:
  64.     This will flash all the screens in the system five times, while
  65.     also flashing the relevant item in its window.
  66.  
  67. 2.  Requester:
  68.     This will put up a 'requester' informing you of the alarm.
  69.     Click into the requester to continue.  The requester will pop
  70.     up on ANY screen.
  71.  
  72. 3.  Beep:
  73.     This will beep three times.
  74.  
  75. 4.  Speech:
  76.     The program will speak to you informing you of the alarm.
  77.     (If the translator.library is not in the LIBS: directory, this option
  78.     will not work.)
  79.  
  80. 5.  No Alarm:
  81.     DSD will just ignore the alarm.
  82.  
  83.  
  84.  
  85. ALARM LEVEL:
  86. -----------
  87.  
  88.     The Alarm level normally is 5% of the total capacity of the device
  89. with a minimum alarm level of 50k.  You can change the Alarm level by
  90. clicking on the device row you want to change.  A gadget will appear at
  91. the bottom of the window.  Enter the new Alarm level and hit return.
  92.  
  93.  
  94.  
  95. UPDATE RATE:
  96. ------------
  97.  
  98.     DSD updates it display once every 3 seconds.  This can be changed to
  99. anything between 1 second and 15 minutes.  To do this, click on the 'update
  100. speed' gadget (it's a tiny block normally in the upper right hand corner
  101. of the window, next to the title line.)  To change the update rate, click
  102. on this gadget and hold it down, the window's title will display the current
  103. update rate, move the mouse up or down to change the update rate.  Let go
  104. of the mouse button when you find a rate you like.
  105.  
  106.     If you need an immediate update of the display, just click on the first
  107. line in the window.  (The one with the titles.)  DSD will also update the
  108. display every time a disk is inserted or removed from the drive.
  109.  
  110.  
  111.  
  112. DSD'S WINDOW:
  113. -------------
  114.  
  115.     The window is mostly fairly clear except for the following:
  116.  
  117. -   If a floppy disk has the write-protect tab on, an asterisk (*) will
  118.     appear next to the 'Free' number corresponding to that disk.
  119.  
  120. -   Also, if AmigaDOS is currently validating a disk, a 'V' will appear
  121.     next to the 'Free' number corresponding to that disk.  If this happens,
  122.     the info for that disk might not be correct.  Be careful.  Anyway, you
  123.     should not write to a disk as long as it is validating.
  124.  
  125. -   DSD's window will be as tall as it needs to be to display all the
  126.     mounted devices.  The limit for that is 20 devices.
  127.  
  128. -   The RAM Disk Size display applies to the normal RAM Disk and not VD0:
  129.     or RAD: as those would appear with the normal disk list.  If the RAM
  130.     Disk has not been accessed yet, DSD will start it up and display
  131.     'RAM Disk Empty'.  If DSD can't start up the RAM Disk for any reason,
  132.     it will display 'RAM Disk Not Initialized.' 
  133.  
  134.  
  135.  
  136. DEVICE SELECTION AND REMOVAL:
  137. -----------------------------
  138.  
  139.     You can remove devices from the display if you do not need them.  This
  140. is accomplished by 'selecting' a device from the list.  (To select a device
  141. click on its line TWICE.)  Then select 'Remove Selected' from the menu.
  142. (More on this later.)  When a device is removed, it will no longer be
  143. checked for its alarm level.  There are many 'Remove' options.  These will
  144. be discussed in the Menus section.
  145.  
  146.  
  147.  
  148. MENUS:
  149. ------
  150.  
  151.     DSD has the following menus attached to it:
  152.  
  153.  
  154. -   Options Menu:
  155.     -------------
  156.  
  157.     -   Reset All:
  158.         Resets the device list.
  159.  
  160.     -   Clear Selections:
  161.         Clears all 'selected' disks.
  162.             
  163.     -   Memory Display:
  164.         Turns the memory display box on/off.
  165.  
  166.     -   Time Display:
  167.         DSD displays the time and date on its window title.  This menu item
  168.         will turn this off or on.
  169.  
  170.     -   Display Memory Chunks / Display Memory Total:
  171.         This toggles the Chunk or Total memory display.
  172.  
  173.     -   Display Memory Size / Display Memory Usage:
  174.         Toggles the Memory Size or Memory Usage display.
  175.  
  176.     -   RAM Disk Display:
  177.         Turns the RAM Disk size box on/off.
  178.  
  179.     -   Display Volume Names:
  180.         Toggles Volume name display on/off.
  181.  
  182.     -   Go To Sleep:
  183.         Selecting this item will put the program to sleep.  It wil close its
  184.         window and open up a tiny window instead.  The program will be frozen
  185.         during that time.  To return to normal just click into the tiny
  186.         window and the original window will be back.
  187.  
  188.     -   Shrink Window:
  189.         This will shrink DSD's window to just the title bar.  This will NOT
  190.         affect any other operation of the program.  I.E. alarms will still
  191.         work, unlike the 'Sleep' mode.
  192.  
  193.     -   Pop up to front:
  194.         When this option is selected, DSD's window will always 'pop up' on
  195.         whatever screen is on front.
  196.  
  197.     -   Quit:
  198.         Guess what this does!  :-)
  199.  
  200.  
  201. -   Remove Menu:
  202.     ------------
  203.  
  204.     This menu has all the different 'Remove' options.  They are:
  205.  
  206.     -   Selected:
  207.         This will remove just the 'selected' disks.  You can have more than
  208.         one selected disk at the same time.
  209.  
  210.     -   Unselected:
  211.         This will remove all the disks except the selected ones.  Useful when
  212.         you only want to see one or two devices.
  213.  
  214.     -   Floppies:
  215.         Removes all devices beginning with 'DF'.
  216.  
  217.     -   Not Floppies:
  218.         Removes all devices not beginning with 'DF'.
  219.  
  220.     -   < Alarm Level:
  221.         Removes all devices that are below the Alarm Level.
  222.  
  223.     -   > Alarm Level:
  224.         Removes all devices that are above the Alarm Level.
  225.  
  226.     -   Empty Drives:
  227.         Removes all drives that have no disk in them.
  228.  
  229.     -   Everything:
  230.         Removes ALL the devices from the list.
  231.  
  232.  
  233. -   Screens Menu:
  234.     -------------
  235.  
  236.     This menu has a list of the currently available 'screens' in the system,
  237.     with the screen on which DSD's window is currently living marked with a
  238.     checkmark.
  239.  
  240.     To move DSD's window to any other screen, just select its name from the
  241.     menu.
  242.  
  243.  
  244.  
  245.  
  246. COMMENTS:
  247. ---------
  248.  
  249.     -   The time/date display will only be updated as often as the update
  250.         time you selected.
  251.  
  252.     -   Be careful when selecting an update rate of 1 second.  This can
  253.         take too much time from the processor.  2 seconds is okay, but I
  254.         find the optimal to be between 10 and 15 seconds if you are not
  255.         using drives a lot, and between 3 and 5 if you are.
  256.  
  257.     -   DSD's window will always come up as inactive.  It will
  258.         also turn itself into inactive after a fixed period.  (around
  259.         10 to 60 seconds, depending on the update rate.)
  260.  
  261.     -   DSD knows about WBLace V3.00 or higher (by the same
  262.         author), and will close its window for about 2 seconds when
  263.         WBLace requests this from it.  This is in order to allow WBLace
  264.         to change the Workbench Interlace setting on or off.  If you don't
  265.         have WBLace, you can find it in the AmigaForum on Compuserve in DL13
  266.         as WBLCE3.ARC.
  267.  
  268.     -   DSD takes little processor time.  For example, with three disks
  269.         displayed, DSD will only consume about 1% of processing time (at an
  270.         update rate of 5 seconds.)  Its memory usage is around 18-19k.  But
  271.         be careful if you have more than 10 disks on the list.  It can get
  272.         very busy.
  273.  
  274.  
  275.  
  276. KNOWN BUGS:
  277. -----------
  278.  
  279.     -   If any program takes complete control of a drive, (e.g. DiskCopy,
  280.         Format, DiskDoctor, DiskSalv) DSD will not be able to
  281.         check that drive, and it will display '- No Disk Present -'. 
  282.         I can't currently find a way around this.  (Maybe I shouldn't
  283.         mess with the drive when it's busy anyway.)
  284.  
  285.     -   If any program closes its screen while DSD is living on that screen,
  286.         DSD will pop back up to the current screen, BUT you will lose 704
  287.         bytes from the system.  If you want to close a program's screen
  288.         while DSD is still on it, first move DSD to another screen.  I also
  289.         have added something to help here, just select my name from the
  290.         'Options' menu and the DSD will disappear for 10 seconds, enough time
  291.         for you to close the other program's screen.  DSD will then come back
  292.         up on the front screen.
  293.  
  294.     -   DSD runs at a priority of -2.  So, if there is a lot of activity in
  295.         the system, the update rate will not be correct.  I.E.  An update
  296.         rate of 3 seconds will means that DSD will update its display NOT
  297.         LESS THAN every 3 seconds.  It might take upto 5 or 6 seconds to
  298.         update its display.  I have added this to remove problems with DSD
  299.         taking as much as 10% of processor time if it's busy.
  300.  
  301.     -   DSD currently uses Forbid() and Permit() a lot, this means that at
  302.         times, the mouse pointer will freeze for a split-second while it
  303.         is moving.  Sorry about this, but it's better than getting a guru!  
  304.  
  305.  
  306.  
  307. PLEASE! PLEASE!
  308.  
  309.  
  310.     If you have any ideas on what can be added to this program, easyplex
  311. me with your ideas, as I have run out of them!
  312.  
  313.  
  314.     Any comments, suggestions, complaints, etc. should be sent to me on
  315. Compuserve ID: 75166,2531.
  316.  
  317.  
  318.     This program is Freely Distributable, you can spread it as much as you
  319. like as long as you keep this file with it, and don't modify either the
  320. program or this documentation.
  321.  
  322.  
  323.     I hope you find this program as useful as I do.
  324.  
  325.  
  326.                                 By: Khalid Aldoseri.
  327.                                     CIS: 75166,2531.
  328.                                               _ 
  329.                                       | /    | |                        
  330.                                       |/     |_|
  331.                                       |\     | |
  332.                                       | \ o  | | o
  333.